home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / dwarf.z / dwarf
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDWWWWAAAARRRRFFFF((((4444))))                                                              DDDDWWWWAAAARRRRFFFF((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dwarf - dwarf version 2 debugging information format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddwwwwaaaarrrrffff....hhhh>>>>
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _D_W_A_R_F is a format for the information generated by compilers, assemblers,
  16.      and linkage editors that is necessary for source-level debugging.  It
  17.      allows a compact representation of programs in many languages and is
  18.      easily extended to handle additional languages and individual
  19.      compiler/debugger requirements.  Consumers reading _D_W_A_R_F information they
  20.      do not understand are able to easily skip past that information, meaning
  21.      that older consumers are not broken by the addition of new features.
  22.  
  23.      _D_W_A_R_F itself does not specify how to generate or use the information.
  24.      Instead, it defines the 'bits on the disc'.  See the _l_i_b_d_w_a_r_f(4) man page
  25.      for information on reading and writing _D_W_A_R_F information.
  26.  
  27.      This format was designed by a multi-company committee called the _P_L_S_I_G
  28.      working under the auspices of Unix International.  The format is based on
  29.      the SVR4 debugging information format, (which might be called version 0)
  30.      and a codification of that format developed by the committee (which was
  31.      called version 1).  Version 2 was designed by the committee to reduce the
  32.      disk space used and to add descriptive power (as compared to versions 0
  33.      and 1).  The Version 2.0.0 Industry Review Draft was made available July,
  34.      1993.  The document provided below is that Draft.
  35.  
  36.      For details of the format see the document DDDDWWWWAAAARRRRFFFF DDDDeeeebbbbuuuuggggggggiiiinnnngggg IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  37.      FFFFoooorrrrmmmmaaaatttt, which is the file _d_w_a_r_f._v_2._m_m in the IDO/dev option subsystem
  38.      _c_o_m_p_i_l_e_r__d_e_v._o_p_t._d_w_a_r_f.  The file _i_n_d_e_x._v_2._m_m is an index to that
  39.      document.  The ._p_s files are PostScript versions of the same files.
  40.  
  41.      The _D_W_A_R_F debugging information is present only in programs compiled -n32
  42.      or -64.  This information is put, as needed, into sections of an ELF
  43.      object file named ._d_e_b_u_g__i_n_f_o, ._d_e_b_u_g__f_r_a_m_e, ._d_e_b_u_g__l_i_n_e, ._d_e_b_u_g__a_r_a_n_g_e_s,
  44.      ._d_e_b_u_g__l_o_c, ._d_e_b_u_g__f_r_a_m_e, ._d_e_b_u_g__s_t_r, ._d_e_b_u_g__a_b_b_r_e_v, ._d_e_b_u_g__p_u_b_n_a_m_e_s,
  45.      ._d_e_b_u_g__w_e_a_k_n_a_m_e_s, ._d_e_b_u_g__f_u_n_c_n_a_m_e_s, ._d_e_b_u_g__t_y_p_e_n_a_m_e_s, and
  46.      ._d_e_b_u_g__v_a_r_n_a_m_e_s.
  47.  
  48.      With programs compiled -32, the compiler puts debugging information into
  49.      the ._m_d_e_b_u_g section of the ELF file (the section format is identical to
  50.      the IRIX 4 COFF symbol table, so the ._m_d_e_b_u_g section is sometimes
  51.      referred to as 'the symbol table', though this is incorrect terminology
  52.      now).
  53.  
  54. FFFFIIIILLLLEEEESSSS
  55.      /usr/share/src/compiler/dwarf/dwarf.v2.mm
  56.      /usr/share/src/compiler/dwarf/dwarf.v2.ps
  57.      /usr/share/src/compiler/dwarf/index.v2.mm
  58.      /usr/share/src/compiler/dwarf/index.v2.ps
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDWWWWAAAARRRRFFFF((((4444))))                                                              DDDDWWWWAAAARRRRFFFF((((4444))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      libdwarf(4) dwarfdump(1)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.